The Game Master (3rd Edition)/The Game Master 3rd edition.iso/files/demo_vga/manjul/man.exe/MANDEL.DOC

Text File | 1992-01-27 | 10.1 KB | 288 lines

           Mandelbrot - Julia Set Generator

  Note: Most commands can be interrupted by a simple
mouse click.
  ┌────────┐
  │ Set    │
  │ Values │
  └────────┘
  The Set Values command allows the user to set the
initial parameters that will be used by MANDEL to
begin generating a new image. These values are also
available for inspection when an image has been
displayed. The values and their range are:

  X center value               -10 to 10
  Y center value               -10 to 10
  Magnification                >0
  A value (if a Julia image)   -10 to 10
  B value (if a Julia image)   -10 to 10
  Maximum dwell                1 to 8191
  Image width in pixels        10 to 4800
  Image type [M J]             M or J
  Full/Partial image [F P]     F or P
  Default color mask file name xxxxxxxx.MSK
  Display type [0 1]           For future use
  256 color palette number     For future use
  Image file name              xxxxxxxx.MAN
                            or xxxxxxxx.MAR

  The A and B values are only displayed with Julia
images. If the recursive image generator is used the
image width must be a member of the 2^N set, ie. 16,
32, 64, 128... etc. The program maintains the
Full/Partial image status and these values cannot be
changed by the user.

  ┌────────┐
  │ Color  │
  │ Masks  │
  └────────┘

  When the Color Masks command is chosen a pop up
window presents the four options:

    ┌───────────────────────────┐
    │ Create/Display color mask │
    └───────────────────────────┘
    ┌───────────────────────────┐
    │     Select color mask     │
    └───────────────────────────┘
    ┌───────────────────────────┐
    │      Select palette       │
    └───────────────────────────┘
    ┌───────────────────────────┐
    │           QUIT            │
    └───────────────────────────┘

  Clicking on the Create/Display color mask option
allows the user to create, edit and save color masks.
  Clicking on the Color mask file name box allows you
to type in a file name. The file name must have the
extension .MSK or you will not be able to select it
later. Ranges of dwell values should be typed into the
squares on the left. Just click on the square, type in
a dwell value and <Enter>. The colors are selected by
clicking on the desired color of the color wheel in
the upper right and then clicking on the odd and even
boxes at the right. The selected color is displayed
between the circular menu and the color wheel. If the
first line of the color mask reads:

             0  9  [blue box] [white box]

then dwell values from 0 to 9 will be colored blue if
odd and white if even. If a solid color is desired the
color boxes should be filled with the same color. The
end of a color mask should be designated with a
negative value entered into the first dwell box.  The
default color mask on startup is M1.MSK and its values
are:

            0   9  [  blue box] [ white box]
           10  19  [   red box] [   red box]
           20 510  [yellow box] [yellow box]
          511 511  [ black box] [ black box]
           -1

  In the case of M1.MSK, any dwell values larger than
511 will be colored black (color 0 in the default
palette).
  The circular menu at the upper left has four
options. Clicking on the up or down arrow jumps to the
next or previous 16 color mask entries. A total of 256
entries can be placed in one color mask. The SAVE
option stores the color mask currently displayed under
the name specified in the Color mask file name box.
The new color mask will become the currently selected
color mask.
  Clicking on the Select color mask option presents
the user with a large window and the names of the
color masks that have been stored. Clicking on a color
mask name will select and load that color mask. It
then can be viewed by selecting the Create/Display
color mask option.
  Clicking on the Select palette option opens a window
that displays the current VGA color palette of 16
colors. Clicking on the Default box will load the
default VGA color palette. Clicking on the arrows will
select other prestored color palettes, up to number
57.

  The QUIT option returns the user to the main menu.

  ┌────────┐
  │ Make   │
  │ Image  │
  └────────┘

  Selecting the Make Image command generates a
Mandelbrot or Julia image based upon the parameters
entered in the Set Values command. A warning is issued
before the generation begins to allow the user to
change the file name, as any existing file of this
name will be erased.
  A very simple way to generate images is first to use
Load Image to display a previously generated image.
Double clicking on the image will produce a zoom
window overlaid on the display. Clicking and holding
down the left mouse button allows the zoom window to
be dragged about the image to an interested portion of
the image. The zoom window can be resized by dragging
the mouse pointer to the left and right outside the
zoom window. Once the zoom window has been positioned
and sized, clicking on the gray panel at right will
automatically store the new zoomed values into the Set 
Values area. The user will probably wish to enter a
new image file name using the Set Values command (this
will prevent the original image file from being
erased), and then generate a new image of the area
defined by the zoom window with the Make Image
command. While the zoom window is present the
procedure can be cancelled by clicking on the right
gray panel around the command buttons.

  ┌────────┐
  │ Load   │
  │ Image  │
  └────────┘

  The Load Image command presents the user with a list
of image file names that have been produced with the
.MAN extension. Clicking on a file name will display
the image with the current color mask if the selected
image has no default color mask file name. A brief
double tone is sounded if there is no default color
mask file name. If a color mask name was included when
the image was generated, this color mask will be
loaded before the image is displayed. Partially
generated images will automatically continue
generation when displayed with this command. Once an
image is displayed, double clicking on the image will
produce a zoom window as described under the Make 
Image command.

  ┌────────┐
  │ Make R │
  │ Image  │
  └────────┘

  The Make R Image command functions similarly to the
Make Image command except a recursive procedure is
used in place of the normal line by line generation.
The image file should be given the .MAR extension so
that it will be properly handled when using the Load R 
Image command. In some cases this recursive procedure
will generate images faster that the normal method.
Partially generated images cannot be displayed with
generation automatically continuing as is the case
with the normal Load Image command. Image files are
generally larger with the recursive procedure.

  ┌────────┐
  │ Load R │
  │ Image  │
  └────────┘

  The Load R Image command displays a recursive image
previously generated with a .MAR extension in the file
name. A list of such files is presented and the
selected image is clicked on. Partially generated
images will not be automatically continued as with the
Load Image command.

  ┌────────┐
  │ 3-D    │
  │ Image  │
  └────────┘

  The 3-D Image command displays an image generated
with the Make Image command in a pseudo 3-D style. The
display algorithm is a simple one, but very slow.
VGA displays have limitations when displaying 3-D
Mandelbrot images. Best results occur with color masks
that contain multiple colors and have the dwell ranges
broken into many small steps. Large values for the
maximum dwell may result in the top of the image being
lost. Partially generated images will not be
automatically continued as with the Load Image
command.

  ┌────────┐
  │ Plot   │
  │ Dwell  │
  └────────┘

  The Plot Dwell command reads all the dwell values of
an image stored with the .MAN extension and sums them.
The sums are then plotted with the current color mask
used for each dwell value plotted. Only dwell values
of 2,400 or less will be plotted. These plots give an
indication of how many points in the image have the
various dwell values and can be useful in constructing
a color mask that will display the image to best
advantage.

  ┌────────┐
  │ Make   │
  │ PCX    │
  └────────┘

  The Make PCX command allows the user to select an
image file stored with the .MAN extension and create a
PCX image file using the current color mask. The PCX
image file format allows users to import Mandelbrot
and Julia image files into other software such as
desktop publishing programs and paint programs.

  ┌────────┐
  │ Print  │
  │ Image  │
  └────────┘

  The Print Image command presents the user with three
different printer types that are supported, or the
command can be quit.

    ┌───────────────────────────┐
    │          Epson            │
    └───────────────────────────┘
    ┌───────────────────────────┐
    │           IBM             │
    └───────────────────────────┘
    ┌───────────────────────────┐
    │         Laserjet          │
    └───────────────────────────┘


    ┌───────────────────────────┐
    │           QUIT            │
    └───────────────────────────┘

  The Epson and IBM printers must support a 24 pin
mode. Any printer that supports the Laserjet mode
should also be compatible. QUIT returns the user to
the main menu.

  ┌────────┐
  │ Help   │
  │ File   │
  └────────┘

  The Help File command displays the file you are
currrently reading. Clicking on the arrows to the
right displays the next or previous page.

  ┌────────┐
  │ Quit   │
  │ MANDEL │
  └────────┘

  The Quit MANDEL command returns the user to the DOS
prompt.

                    Theron Wierenga
                      P.O. Box 595
                   Muskegon, MI 49443